home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 029a / dupes310.zip / DUPES.DOC < prev    next >
Text File  |  1992-01-11  |  23KB  |  583 lines
  1.                           --------------
  2.                          |              |
  3.                          |    Dupes     |
  4.                          |              |
  5.                          | Version 3.10 |
  6.                          |              |
  7.                           --------------
  8.                              
  9.  =============================================================== 
  10. | TABLE OF CONTENTS                                             |
  11.  ===============================================================
  12.  
  13.     This file contains the following sections:
  14.  
  15.                   GENERAL
  16.                   EXAMPLES
  17.                   OUTPUT
  18.                   PRINTING OR FILING THE OUTPUT
  19.                   SYSTEM REQUIREMENTS
  20.                   INTERNATIONAL SUPPORT
  21.                   MESSAGES
  22.                   EXIT CODES
  23.                   CREDITS
  24.                   REVISION HISTORY
  25.                   WHAT'S IN THIS PACKAGE
  26.                   REGISTRATION
  27.                   SHAREWARE
  28.                   COPYING
  29.                   OMBUDSMAN
  30.  
  31.  =============================================================== 
  32. | GENERAL                                                       |
  33.  ===============================================================
  34.  
  35.     Dupes lets you recover wasted space on your disks by finding 
  36. duplicate files, empty files & empty directories.  Deleting 
  37. unneeded files & directories gives you more room to store data.
  38. To run Dupes, enter: 
  39.  
  40.  
  41.        DUPES [drive:[/M][/Odir][/X[S]dir]...] [/A] [/S] [?]
  42.  
  43.  
  44.     Arguments in brackets ([]) are optional.  Ellipses (...) show 
  45. arguments you can repeat.  Don't put spaces between the drive 
  46. letter, colon, & the /M, /O & /X arguments.  If you give no drive 
  47. letter, Dupes checks the default drive.  Argument meanings: 
  48.  
  49.  
  50. drive  Disk drive letter.  Don't list a particular drive more 
  51.        than once. 
  52.  
  53. /M     Check multiple disks on a particular drive.  You could use 
  54.        /M to check a series of diskettes. 
  55.  
  56. 2
  57. /Odir  Check only the specified directory & its subordinate 
  58.        directories.  Put the full directory name after the /O, 
  59.        starting with a backslash.  This option is useful on a 
  60.        large, multiuser system where each user has a separate 
  61.        directory.  If you don't use /O, Dupes checks the entire 
  62.        disk (unless you use /X--see below). 
  63.  
  64. /Xdir  Skip the specified directory.  Put the full directory name 
  65.        after the /X, starting with a backslash.  You could use /X 
  66.        if you have a directory where are no duplicate files, but 
  67.        where Dupes' attempts to check might cause sharing 
  68.        violations.  Another use for /X is when you have a 
  69.        directory where you intentionally keep duplicate files. 
  70.  
  71. /XSdir Like /X, except it exempts the specified directory & all 
  72.        its subdirectories.
  73.  
  74. /A     Pause after each group of duplicate files & ask if you 
  75.        want to delete them.  It also makes Dupes ask if you want 
  76.        to delete empty files & directories.  NOTE:  Don't use /A 
  77.        if you redirect Dupes' output.  See the section on Output. 
  78.  
  79. /S     Consider files duplicates only if their names, sizes & 
  80.        date/time stamps are the same.  If you don't use /S, Dupes 
  81.        considers files duplicates if just the names match. 
  82.  
  83. ?      Shows program syntax.
  84.  
  85.  
  86. Note:  If you want to apply /M, /O, /X or /XS to the default 
  87. drive, you must explicitly give its drive letter. 
  88.  
  89.  ===============================================================
  90. | EXAMPLES                                                      |
  91.  ===============================================================
  92.  
  93.  
  94. DUPES 
  95.  
  96. Checks the default drive only.
  97.  
  98. -----------------------------------------------------------------
  99.  
  100. DUPES D:
  101.  
  102. Checks drive D:.
  103.  
  104. -----------------------------------------------------------------
  105.  
  106. DUPES C:  D: 
  107.  
  108. Checks drives C: & D:.
  109.  
  110. -----------------------------------------------------------------
  111.  
  112. 3
  113. DUPES /A /S 
  114.  
  115. Checks the default drive.  It reports files as duplicates only if 
  116. their names, sizes & date/time are the same. After displaying 
  117. duplicates, Dupes asks if you want to delete them. 
  118.  
  119. -----------------------------------------------------------------
  120.  
  121. DUPES A:/M  C: 
  122.  
  123. Checks drives A: & C:, prompting for multiple diskettes in 
  124. drive A:. 
  125.  
  126. -----------------------------------------------------------------
  127.  
  128. DUPES A:  C:/O\WOR 
  129.  
  130. Checks drives A: & C:.  It checks all of drive A:, but only 
  131. directory \WOR (and subordinate directories) on drive C:. 
  132.  
  133. -----------------------------------------------------------------
  134.  
  135. DUPES A:/O\TMP  C:/M  D:/X\WP /S
  136.  
  137. Checks drive A:, but only in directory \TMP & subordinate 
  138. directories.  It checks all of drive C:, prompting for multiple 
  139. diskettes.  It checks all of drive D:, except directory D:\WP. On 
  140. all the checked disks, it considers files duplicates only if 
  141. their name, size & date/time match. 
  142.  
  143. -----------------------------------------------------------------
  144.  
  145. DUPES C:/XS\WINDOWS
  146.  
  147. Checks all of drive C:, except for the \WINDOWS directory & all 
  148. its subdirectories.
  149.  
  150.  
  151. -----------------------------------------------------------------
  152.  
  153. DUPES C:/O\WINDOWS C:/O\DOC
  154.  
  155. Checks only directories \WINDOWS and \DOC on drive C:.
  156.  
  157.  
  158.  =============================================================== 
  159. | OUTPUT                                                        | 
  160.  =============================================================== 
  161.  
  162.     If Dupes finds duplicate files, it shows the file name & 
  163. size, date/time stamp, disk name (if you use /M) & directory of 
  164. each copy.  Example: 
  165.  
  166.  
  167. 4
  168.     CUSTOMER.DBF
  169.       12230  10-13-90  06:46:28a  CUST  A:\
  170.       12230  10-13-90  06:46:28a        C:\CUSTOMER
  171.  
  172.       ^      ^         ^          ^     ^
  173.       File   Date last Time last  Disk  Directory
  174.       size   modified  modified   name
  175.  
  176.  
  177.     In the above example, Dupes found the file CUSTOMER.DBF on 
  178. both drive A: & C:.  Since the two copies have identical sizes & 
  179. date time stamps, they are probably the same file. 
  180.  
  181.     At the end of the file list, Dupes shows how many potential 
  182. duplicates it found, & the estimated disk space you would gain by 
  183. deleting them.  Note:  The number displayed will probably be 
  184. larger than the sum of the file sizes shown in directory 
  185. listings.  This is because it is based on disk cluster size, 
  186. giving a more accurate measure of the disk space the files 
  187. occupy.  If you use the /A argument & have Dupes delete files for 
  188. you, the number reflects the approximate amount of space you can 
  189. save by deleting the remaining duplicate files. 
  190.  
  191.     NOTE:  The appearance of the output depends on your DOS 
  192. country code setting (see the section on International Support). 
  193. The example above uses the United States format.  
  194.  
  195.  =============================================================== 
  196. | PRINTING OR FILING THE OUTPUT                                 | 
  197.  =============================================================== 
  198.  
  199.     Normally, output goes to the screen.  If you have many 
  200. duplicate files, though, the output may quickly scroll off the 
  201. screen.  To avoid this problem, you can send the output to a file 
  202. or printer, to examine at your leisure.   In addition, sending 
  203. the output to a hard disk file usually makes Dupes run faster. 
  204.  
  205. NOTE:  Don't redirect the output if you use the /A option.  If 
  206. you do, you won't see the prompt asking if you want to delete 
  207. files, & the system will seem to have crashed.
  208.  
  209.  
  210.     To send the output to a file, enter:
  211.  
  212.  
  213.          DUPES > DUPES.TXT
  214.  
  215.  
  216.     To send the output to a parallel printer, enter:
  217.  
  218.  
  219. 5
  220.          DUPES > PRN
  221.  
  222.  
  223.     To send the output to a serial printer, enter:
  224.  
  225.  
  226.          DUPES > COM1    (or COM2, or whatever)
  227.  
  228.  
  229.     To print only part of the output, press ^P or ^PrtSc when the 
  230. output reaches the part you want to print. 
  231.  
  232.  
  233.     To make Dupes pause after each full screen, enter:
  234.  
  235.  
  236.          DUPES | MORE
  237.  
  238.  
  239. NOTE:  In this case, the DOS MORE program must be in the current 
  240. directory, or in a directory shown in your PATH environment 
  241. variable.  If you're not familiar with these terms, see your DOS 
  242. manual for details. 
  243.  
  244.  =============================================================== 
  245. | SYSTEM REQUIREMENTS                                           | 
  246.  =============================================================== 
  247.  
  248.     Dupes requires MS-DOS or PC-DOS, version 2.0 or later.  The 
  249. number of files it can handle depends on how much memory you 
  250. have.  It can use up to 640K of memory.
  251.  
  252.  =============================================================== 
  253. | INTERNATIONAL SUPPORT                                         |
  254.  ===============================================================
  255.  
  256.     Dupes can display numbers, dates & times in a format 
  257. appropriate to your country.  By default, it uses United States 
  258. formats.  To specify a different format, use the COUNTRY command 
  259. in your CONFIG.SYS file. For example: 
  260.  
  261.  
  262.     COUNTRY=nnn
  263.  
  264.  
  265. where "nnn" is a three digit country code (usually, your 
  266. country's international telephone dialing code).  Your DOS manual 
  267. has further details on the COUNTRY command. 
  268.  
  269.  =============================================================== 
  270. | MESSAGES                                                      | 
  271.  =============================================================== 
  272.  
  273. Aborted as requested.  You pressed ^C or ^Break.
  274.  
  275. 6
  276. Couldn't delete.  DOS didn't delete the file for some reason.  
  277. Ensure the file isn't "read only" or in use by another program.                 
  278.  
  279. Couldn't get drive data.  For some reason, DOS would not tell 
  280. Dupes what kind of disk was in a drive.  You may have a hardware 
  281. problem. 
  282.  
  283. Delete (Y/N/I/S/?)?  You used /A, so Dupes is asking if you want 
  284. to delete this file.  To delete it, press Y.  To keep it, press 
  285. N.  To ignore this group of files, press I.  To have Dupes stop 
  286. asking if you want to delete files, press S.  To see the meanings 
  287. of these letters, press ?. 
  288.  
  289. Directories must start with backslash.  Omit the drive letter & 
  290. colon when using /O or /X.  Just give the full directory path, 
  291. starting with a backslash (i.e., the root directory). 
  292.  
  293. Directory too long.  The directory name you gave with /O or /X is 
  294. too long (& may not even exist).
  295.  
  296. Empty directories.  The following directories have no files in 
  297. them.  However, they still occupy disk space.  Deleting them (use
  298. the RD or RMDIR command) will free space. 
  299.  
  300. Empty files.  The following files have no data in them, but they 
  301. still occupy disk space.  Deleting them (use the DEL or ERASE 
  302. command) will free space. 
  303.  
  304. No duplicates found.  Dupes found no files with the same name 
  305. (or, if you used /S, with the same name, size & date/time stamp). 
  306.  
  307. No duplicates remaining.  Dupes found duplicate files, but you 
  308. deleted them all. 
  309.  
  310. No such directory.  You gave a non-existent directory name with 
  311. the /O option.
  312.  
  313. No such drive.  You gave a non-existent drive on the command 
  314. line.
  315.  
  316. XXXXX potential duplicate(s)...  Dupes found files that may be 
  317. duplicates, but only you can decide.  Note:  If you use the /A 
  318. option & delete files, the "potential duplicate(s)" message 
  319. reflects the number of files remaining after deletions. 
  320.  
  321. Not enough memory.  Your computer needs more memory to handle all 
  322. the file names on the disk(s).  If you're running other programs 
  323. concurrently, or have resident utilities or device drivers, try 
  324. deinstalling them. If you're running Dupes from a menu system, 
  325. try running it DOS command line instead.
  326.  
  327. Put disk "xxxxx" in drive X:, then press a key.  You used /M, so 
  328. you must insert the proper diskette before Dupes can delete the 
  329. 7
  330. file or directory you requested. 
  331.  
  332. Put (next) disk in drive X: & enter its name.  You used /M & 
  333. Dupes is asking for the diskette (or next diskette) in that 
  334. drive.  Insert the requested diskette, then enter its name (up to 
  335. five characters).  If there are no more diskettes for that drive, 
  336. just press Enter. 
  337.  
  338. Remove? (Y/N/S).  You used /A, so Dupes is asking if you want to 
  339. remove the indicated directory, which is empty.  Press Y to 
  340. remove it, N to not remove it, or S to have Dupes stop asking. 
  341.  
  342. Sorry, you already used that disk name.  This appears when you 
  343. try to re-use a disk name on a drive with the /A option.  Each 
  344. disk name must be unique.
  345.  
  346. Syntax:....  Please check your syntax & try again. 
  347.  
  348. Too many directories.  Dupes can't handle all the directories on 
  349. the specified disk(s).  If possible, try simplifying the 
  350. directory structure, using /O, or checking fewer drives at a 
  351. time. 
  352.  
  353. Too many empty directories.  Dupes can't handle all the empty 
  354. directories on the specified disk(s).  If possible, try 
  355. simplifying the directory structure, using /O, or checking fewer 
  356. drives at a time. 
  357.  
  358. Too many disks.  Dupes can't handle all the specified disk(s).  
  359. If possible, try checking fewer drives at a time. 
  360.  
  361. Too many files - can only handle %lu.  Take the same action as 
  362. for the "Not enough memory" message.
  363.  
  364.  =============================================================== 
  365. | EXIT CODES                                                    |
  366.  ===============================================================
  367.  
  368.     Dupes reports the following exit codes.  You can use these 
  369. with the ERRORLEVEL function in batch files.  If you're not 
  370. familiar with this term, see your DOS manual for details. 
  371.  
  372.     0  No duplicates/empties found
  373.     1  Duplicates/empties found
  374.     2  User aborted
  375.     3  Error occurred
  376.  
  377.  =============================================================== 
  378. | CREDITS                                                       |
  379.  ===============================================================
  380.  
  381.     Dupes was written in C by Richard W. Adams.  It was developed 
  382. with PC-Write & the Microsoft C Optimizing Compiler.
  383.  
  384. 8
  385.     The author is a member of the Association of Shareware 
  386. Professionals (ASP).  You may reach him at the address given in 
  387. REGISTER.DOC.  Should that address no longer be valid, try 
  388. contacting him through the ASP (545 Grover Road, Muskegon, MI 
  389. 49442). The author is also sometimes available on CompuServe 
  390. (76430,1071). 
  391.  
  392.  =============================================================== 
  393. | REVISION HISTORY                                              |
  394.  ===============================================================
  395.  
  396. 1.00  Original version
  397.  
  398. 2.00  Changed name from The Duplicate File Finder
  399.       Added display of file size & date/time stamp
  400.       Added capability to specify drive
  401.       Added /S option
  402.  
  403. 3.00  Added capability to check multiple drives 
  404.       Added capability to find empty directories
  405.       Added /O, /M, /P & /X options
  406.       Greatly improved speed
  407.  
  408. 3.10  Increased the number of files Dupes can handle
  409.       Added check for empty files
  410.       Added /XS option
  411.       Added on line help for deleting files & directories
  412.       Added support for international date, time & number formats
  413.       Changed /P option to /A, for clarity
  414.       Added check for duplicate disk names
  415.       Revised exit codes
  416.  
  417.  =============================================================== 
  418. | WHAT'S IN THIS PACKAGE                                        |
  419.  ===============================================================
  420.  
  421.     This package contains the following files:
  422.  
  423.     DUPES.EXE     The program itself
  424.     DUPES.DOC     Documentation
  425.     REGISTER.DOC  Registration form
  426.     VENDOR.DOC    Catalog of other software available &
  427.                   instructions on ordering disks
  428.  
  429.  =============================================================== 
  430. | REGISTRATION                                                  |
  431.  ===============================================================
  432.  
  433.     Dupes is copyright by Richard W. Adams, all rights reserved.  
  434. Dupes is "shareware"--if you use it for more than 30 days, you 
  435. must register.  To do so, complete the registration form in 
  436. REGISTER.DOC & send it with a check for the indicated amount to 
  437. the author at the address on the form. 
  438.  
  439. 9
  440. When you register, you receive:
  441.  
  442.     o The right to use your copy of Dupes on a single computer.
  443.  
  444.     o Free technical support by mail for three months.
  445.  
  446.     o Eligibility for free copies of future versions, if you're 
  447.       the first to suggest improvements or report bugs that are 
  448.       fixed/incorporated in future versions. 
  449.  
  450.     Not only is registration a legal & ethical requirement, but 
  451. registration fees give shareware authors the incentive to develop 
  452. new software & improve old ones. 
  453.  
  454.     Tax exempt Christian religious organizations & churches are 
  455. eligible for free registration of Dupes for official business.  
  456. Send a written request to the author, & you'll receive 
  457. registration forms.  The registration takes effect when you 
  458. complete & return the forms.  This is a charitable donation. 
  459.  
  460.     Companies, government agencies & other organizations may 
  461. obtain site licenses for Dupes, at greatly reduced unit costs.  
  462. Contact the author for details & a price list. 
  463.  
  464.  =============================================================== 
  465. | SHAREWARE                                                     | 
  466.  =============================================================== 
  467.  
  468.     Shareware distribution gives users a chance to try software 
  469. before buying it. If you try a Shareware program & continue using 
  470. it, you are expected to register.  Individual programs differ on 
  471. details--some request registration, others require it, & some 
  472. specify a maximum trial period.  With registration, you get 
  473. anything from the simple right to continue using the software to 
  474. an updated program with printed manual. 
  475.  
  476.     U.S. & international copyright laws apply to both Shareware 
  477. and commercial software, & the copyright holder retains all 
  478. rights, with a few specific exceptions as stated below.  
  479. Shareware authors are accomplished programmers, just like 
  480. commercial authors, & the programs are of comparable quality. (In 
  481. both cases, there are good programs & bad ones!)  The main 
  482. difference is in the method of distribution.  The author 
  483. specifically grants the right to copy & distribute the software, 
  484. either to all & sundry or to a specific group.  For example, some 
  485. authors require written permission before a commercial disk 
  486. vendor may copy their Shareware. 
  487.  
  488.     Shareware is a distribution method, not a type of software. 
  489. You should find software that suits your needs & pocketbook, 
  490. whether it's commercial or Shareware. The Shareware system makes 
  491. fitting your needs easier, because you can try before you buy. 
  492. And because the overhead is low, prices are low also. Shareware 
  493. has the ultimate money-back guarantee--if you don't use the 
  494. 10
  495. product, you don't pay for it. 
  496.  
  497. DISCLAIMER - AGREEMENT 
  498.  
  499.     Users of Dupes must accept this disclaimer of warranty: 
  500. "Dupes is supplied as is.  The author disclaims all warranties, 
  501. expressed or implied, including, without limitation, the 
  502. warranties of merchantability & of fitness for any purpose. The 
  503. author assumes no liability for damages, direct or consequential, 
  504. which may result from the use of Dupes." 
  505.  
  506.     Dupes is a Shareware program & is provided at no charge for 
  507. your evaluation.  Feel free to share it with your friends, but 
  508. please don't give it away altered or as part of another system.  
  509. The essence of "user-supported" software is to provide personal 
  510. computer users with quality software without high prices, & yet 
  511. to provide incentive for programmers to continue to develop new 
  512. products.  If you find Dupes useful & continue to use it after a 
  513. reasonable trial period, you must pay a registration fee (see 
  514. REGISTER.DOC).  The registration fee licenses one copy for use on 
  515. any one computer at any one time.  You must treat this software 
  516. just like a book.  For example, any number of people may use the 
  517. software & may freely move it from one computer to another, so 
  518. long as it is used on only one computer at a time.  Just as two 
  519. different people can't read a book at the same time. 
  520.  
  521.     Commercial users of Dupes must register & pay for their 
  522. copies of Dupes within 30 days of first use or their license is 
  523. withdrawn.  Contact the author if you're interested in a site 
  524. license. 
  525.  
  526.     Anyone distributing Dupes for any kind of remuneration must 
  527. first contact the author for authorization.  This authorization 
  528. is hereby granted to distributors recognized by the (ASP) as 
  529. adhering to its guidelines for shareware distributors, & such 
  530. distributors may begin offering Dupes immediately. (However, they 
  531. must still advise the author so he can keep them up-to-date with 
  532. the latest version of Dupes.) 
  533.  
  534.     You are encouraged to pass a copy of Dupes to your friends 
  535. for evaluation.  Please encourage them to register their copy if 
  536. they find it useful.
  537.  
  538.  =============================================================== 
  539. | COPYING                                                       | 
  540.  =============================================================== 
  541.  
  542. You may copy & distribute Dupes freely, as long as you:
  543.  
  544.     o Don't distribute it for commercial purposes without written 
  545.       permission from the author (except ASP distributors; see 
  546.       above). 
  547.  
  548.     o Charge no fee other than a nominal one to cover distribution 
  549. 11
  550.      costs. 
  551.  
  552.     o Don't rent or lease the software.   
  553.  
  554.     o Include all constituent files (see the section titled 
  555.       "WHAT'S IN THIS PACKAGE") 
  556.  
  557.     o Don't change the software or documentation.
  558.  
  559.  
  560.  =============================================================== 
  561. | OMBUDSMAN                                                     | 
  562.  =============================================================== 
  563.  
  564.     The author is a member of the Association of Shareware 
  565. Professionals (ASP).  ASP wants to make sure that the shareware 
  566. principle works for you. If you can't resolve a shareware related 
  567. problem with an ASP member by contacting the member directly, ASP 
  568. may be able to help.  The ASP Ombudsman can help you resolve a 
  569. dispute or problem with an ASP member, but does not provide 
  570. technical support for members' products.  Please write to the ASP 
  571. Ombudsman at 545 Grover Road, Muskegon, MI 49442 or send a 
  572. CompuServe mail message to the ASP Ombudsman (70007,3536). 
  573.  
  574.         _______
  575.    ____|__     |                (R)
  576. --|       |    |-------------------
  577.   |   ____|__  |  Association of
  578.   |  |       |_|  Shareware
  579.   |__|   o   |    Professionals
  580. -----|   |   |---------------------
  581.      |___|___|    MEMBER
  582.  
  583.